home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d21 / commo421.arc / COMMO.DOC < prev    next >
Text File  |  1990-07-19  |  77KB  |  2,162 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                   {COMMO} (tm)
  9.  
  10.  
  11.                      Telecommunications for PC Compatibles
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                       by
  20.  
  21.                                 Fred P. Brucker
  22.  
  23.                              Post Office Box 9103
  24.                              Santa Rosa, CA 95405
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                  Release 4.21
  31.  
  32.                                 April 14, 1990
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.        This program and associated documentation are the property of the
  44.        author and may not be sold without permission.  They may be freely
  45.        distributed, unaltered and as a unit, via electronic bulletin board
  46.        systems.  Permission to distribute on diskette or in any other
  47.        manner must be obtained in writing.
  48.  
  49.        The author does not guarantee the program to be free from defects
  50.        and may not be held responsible for loss caused by such.  Your use
  51.        of this program constitutes your acceptance of these terms.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.          (C) Copyright 1989,1990  Fred P. Brucker  All Rights Reserved
  62.  
  63.  
  64.  
  65.                           Welcome to {COMMO} (tm)                   page ii
  66.  
  67.  
  68.        ---------------------
  69.        Licensing Information
  70.        ---------------------
  71.  
  72.        {COMMO} is not a public domain program and is not free.  It is
  73.        classified as "SHAREWARE."  What this means is that you may use the
  74.        program for 30 days to determine its suitability to your
  75.        application.  If after that time you decide to continue using
  76.        {COMMO} you must pay the registration fee.
  77.  
  78.        {COMMO} is a unique program and represents a great deal of work.  A
  79.        lot of functionality has been compressed into a small package, and
  80.        more features are being added on a continuing basis.  If you find
  81.        {COMMO} useful and enjoyable, you can help support future
  82.        improvements by registering your copy.
  83.  
  84.  
  85.        A single-user license is $25.00.  A diskette (5.25" or 3.5") will be
  86.        provided for a $5.00 handling fee.  Send a check or money order (US
  87.        funds) to the address below.
  88.  
  89.        Details and multi-user (site) license information are provided in
  90.        the file REGISTER.FRM.
  91.  
  92.         
  93.        Thank you, and I hope you enjoy {COMMO}.
  94.  
  95.  
  96.                                              Fred P. Brucker
  97.  
  98.                                              P.O. Box 9103
  99.                                              Santa Rosa, CA 95405
  100.  
  101.  
  102.  
  103.                           Welcome to {COMMO} (tm)                  page iii
  104.  
  105.  
  106.  
  107.                                    Contents
  108.                                    --------
  109.  
  110.           Principal Features . . . . . . . . . . . . . . . . . . . . .    1
  111.           The Best Way to Learn {COMMO} Quickly  . . . . . . . . . . .    2
  112.           Operations Guide / Command Summary . . . . . . . . . . . . .    3
  113.           The Internal Editor  . . . . . . . . . . . . . . . . . . . .    6
  114.  
  115.           Uploading / Downloading  . . . . . . . . . . . . . . . . . .    6
  116.                {COMMO} Auto Receive  . . . . . . . . . . . . . . . . .    6
  117.  
  118.           Getting Started  . . . . . . . . . . . . . . . . . . . . . .    7
  119.                Command Line Options  . . . . . . . . . . . . . . . . .    8
  120.                {COMMO} Support Files . . . . . . . . . . . . . . . . .    9
  121.                Initialization Procedure  . . . . . . . . . . . . . . .   10
  122.                Terminal Screen . . . . . . . . . . . . . . . . . . . .   10
  123.           How to Use Online Help . . . . . . . . . . . . . . . . . . .   11
  124.           Modifying the Help File  . . . . . . . . . . . . . . . . . .   11
  125.  
  126.           Programming {COMMO} Macros . . . . . . . . . . . . . . . . .   12
  127.                Macro-id and Function Summary . . . . . . . . . . . . .   13
  128.                Additional Macro File Rules . . . . . . . . . . . . . .   13
  129.                Executing Macros  . . . . . . . . . . . . . . . . . . .   13
  130.                Additional Macro Execution Rules  . . . . . . . . . . .   14
  131.           {COMMO} Macro Functions  . . . . . . . . . . . . . . . . . .   15
  132.           Table of {COMMO} Key-id's  . . . . . . . . . . . . . . . . .   29
  133.  
  134.           Appendix A   Setting Up Your Modem . . . . . . . . . . . . .   30
  135.           Appendix B   {COMMO} and Multi-Tasking . . . . . . . . . . .   32
  136.                DESQview  . . . . . . . . . . . . . . . . . . . . . . .   32
  137.                OmniView  . . . . . . . . . . . . . . . . . . . . . . .   33
  138.           Appendix C   XON/XOFF Protocol . . . . . . . . . . . . . . .   34
  139.           Appendix D   ASCII Character Representation  . . . . . . . .   35
  140.           Appendix E   Terminal Emulation  . . . . . . . . . . . . . .   37
  141.                Printer Support . . . . . . . . . . . . . . . . . . . .   37
  142.                ANSI Keyboard Support . . . . . . . . . . . . . . . . .   37
  143.                VT102 Keyboard Simulation . . . . . . . . . . . . . . .   38
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.        LIST is a product of Vernon D. Buerg
  151.        DESQview is a trademark of Quarterdeck Office Systems
  152.        OmniView is a trademark of Sunny Hill Software
  153.        DSZ is a product of Omen Technology Inc.
  154.        AutoDownload is a trademark of Omen Technology Inc.
  155.        Puma is a product of Matthew Thomas
  156.  
  157.  
  158.  
  159.                           Welcome to {COMMO} (tm)                   page 1
  160.  
  161.  
  162.        ------------------
  163.        Principal Features
  164.        ------------------
  165.  
  166.        {COMMO} is small in size and executes quickly.
  167.  
  168.        Powerful Macro Processor allows you to:
  169.  
  170.        1) write macro "programs" to automate many common operations such as
  171.           logins, reading messages, uploading/downloading.  You can sit
  172.           back and watch {COMMO} do the work -- or you can let {COMMO}
  173.           perform these tasks in the middle of the night while you sleep.
  174.  
  175.        2) assign any Function Key, Alt Key or Keypad Key to send a string
  176.           to the modem, execute any DOS command, start any macro or
  177.           initiate any {COMMO} function.
  178.  
  179.        3) edit all macros without exiting {COMMO}, using the Internal
  180.           Editor.  
  181.  
  182.        Unlimited entries in the Dialing Directory.  Multi Number Dialing
  183.        supported from the command line.  AutoBaud detect.  Macro may be
  184.        linked to each directory entry.
  185.  
  186.        Multi-tasking support.  {COMMO} is DESQview aware, operates in about
  187.        40k and will execute with DSZ in a 110k DV window (depending on
  188.        support file sizes).  Also supports the TopView interface (with
  189.        automatic screen updating, such as in OmniView).
  190.  
  191.        Built-in ANSI-BBS and VT102 emulation.  Supports ANSI editing
  192.        functions, scrolling region, graphics character set, tab set/clear,
  193.        printing, modes, reports, etc.  Complete auto-switching VT102
  194.        keyboard support via Macro Processor.
  195.  
  196.        ASCII Upload to send messages and text files.  Features line pacing
  197.        and blank line expansion.
  198.  
  199.        Configuration File, Dialing Directory and Macro File may be edited
  200.        with full-function Internal Editor.  String search available in all
  201.        file windows.  Most features are fully configurable.
  202.  
  203.        Split-screen Chat Mode -- all program features are available while
  204.        in Chat Mode.
  205.  
  206.        {COMMO}'s Auto Receive feature recognizes Zmodem AutoDownload and
  207.        Puma Auto-Start sequences, automatically triggering the macro of
  208.        your choice.
  209.  
  210.        Support for any four serial ports.  Port addresses and IRQ's are
  211.        configurable.  Port speeds up to 115,200 bps (machine dependent). 
  212.        Support for NS16550A buffered UART chip.
  213.  
  214.        Serial port signal lights may be displayed on status line, including
  215.        send and receive.
  216.  
  217.  
  218.  
  219.                           Welcome to {COMMO} (tm)                   page 2
  220.  
  221.  
  222.        Capture Log to save all text from the screen to a disk file.
  223.        Screen Image Save to write current screen to a disk file.
  224.        Print Log to write all text from the screen to the printer.
  225.  
  226.        Extensive context-related Online Help.
  227.  
  228.  
  229.        And {COMMO} is elegant, easy to learn and fun to use!
  230.  
  231.  
  232.  
  233.                   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  234.                   -------------------------------------
  235.                   The Best Way to Learn {COMMO} Quickly
  236.                   -------------------------------------
  237.                   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  238.  
  239.  
  240.        1) Read the section "Operations Guide / Command Summary" for a   
  241.           quick introduction to all of {COMMO}'s commands and features.
  242.  
  243.        2) Read Appendix A "Setting Up Your Modem" for some very important
  244.           instructions pertaining to your specific hardware.
  245.  
  246.        3) Read the section "Getting Started" which will get you up and
  247.           running.
  248.  
  249.        4) Use the extensive Online Help to learn the operating details   
  250.           of the program as you use it.
  251.  
  252.  
  253.        How is it pronounced???  Just like "comma" (,) except for the last
  254.        letter.  It's technical jargon for "communications."
  255.  
  256.  
  257.  
  258.                           Welcome to {COMMO} (tm)                   page 3
  259.  
  260.  
  261.        ----------------------------------
  262.        Operations Guide / Command Summary
  263.        ----------------------------------
  264.  
  265.        Use {COMMO}'s Online (context-related) Help facility to obtain
  266.        operating details for most features.  This section is an overview of
  267.        {COMMO} features and commands, which you should peruse to gain
  268.        rapid, overall familiarity with the program.
  269.  
  270.        (A special section in this document "Programming {COMMO} Macros" is
  271.        devoted to the Macro Processor.  Additionally there are several
  272.        appendices which give details about special program features.)
  273.  
  274.        Note:  the Alt Keys shown are the built-in default key assignments
  275.        for the various {COMMO} functions.  Once you are familiar with these
  276.        functions you may reassign any of the keys using the Macro
  277.        Processor.
  278.  
  279.  
  280.        [Alt-A]   ASCII Upload
  281.        -------   ------------
  282.        Sends prepared messages and other text files to the remote system. 
  283.        This command features Line Pacing or XON/XOFF protocol to control
  284.        the flow of data.
  285.  
  286.  
  287.        [Alt-B]   Send Break Signal
  288.        -------   -----------------
  289.        Sends a Break Signal, used by some systems to interrupt an
  290.        operation.
  291.  
  292.  
  293.        [Alt-C]   Clear Screen
  294.        -------   ------------
  295.        Clears the Terminal Screen to the default colors.
  296.  
  297.  
  298.        [Alt-D]   Dialing Directory
  299.        -------   -----------------
  300.        Maintains a data base of telephone numbers and related information. 
  301.        Dials numbers to establish connections with remote systems. 
  302.        Directory can be updated with the Internal Editor.
  303.  
  304.  
  305.        [Alt-G]   Configuration File
  306.        -------   ------------------
  307.        Contains settings for many of {COMMO}'s operating parameters.  Can
  308.        be modified with the Internal Editor.  Details in Online Help.
  309.  
  310.  
  311.        [Alt-H]   Online Help
  312.        -------   -----------
  313.        Context-related Online Help is available at any time from anywhere
  314.        within {COMMO}.  See also the section "How to Use Online Help."
  315.  
  316.  
  317.  
  318.                           Welcome to {COMMO} (tm)                   page 4
  319.  
  320.  
  321.        [Alt-I]   Screen Image Save
  322.        -------   -----------------
  323.        Appends the image of the current Terminal Screen to a disk file. 
  324.        Very useful for selectively recording information.  Allows you to
  325.        change the name of the Screen Image File at any time.  See also
  326.        "Capture File Options."
  327.  
  328.  
  329.        [Alt-L]   Set Terminal Parameters
  330.        -------   -----------------------
  331.        Changes the current Serial Port, Data Rate, Data Format or Terminal
  332.        Emulation Type.
  333.  
  334.  
  335.        [Alt-M]   Macro Processor
  336.        -------   ---------------
  337.        Executes and maintains {COMMO} macros.  See the section "Programming
  338.        {COMMO} Macros" which shows you how easily you can automate program
  339.        operations, link to external protocols (for Uploading/Downloading),
  340.        assign keys and perform a myriad of other functions.  The Macro File
  341.        is maintained with the Internal Editor.
  342.  
  343.  
  344.        [Alt-O]   Send Modem Initialization String
  345.        -------   --------------------------------
  346.        Used to re-initialize your modem, if necessary.
  347.  
  348.  
  349.        [Alt-P]   Send Current Password
  350.        -------   ---------------------
  351.        Sends the Password String defined by the last dialing operation. 
  352.        This feature allows a different Password for each system that you
  353.        call.
  354.  
  355.  
  356.        [Alt-Q]   Quit Call
  357.        -------   ---------
  358.        Places modem "on-hook" by dropping DTR.  Used to "hang up" the
  359.        telephone line.
  360.  
  361.  
  362.        [Alt-S]   Shell to DOS
  363.        -------   ------------
  364.        Allows you to enter DOS while {COMMO} remains in memory.
  365.  
  366.  
  367.        [Alt-U]   Multi Number Dialing
  368.        -------   --------------------
  369.        Multiple numbers may be "marked" in the Dialing Directory, then
  370.        automatically dialed in sequence until a connection is established. 
  371.        See "Command Line Options" and "Programming {COMMO} Macros" for
  372.        details on marking numbers.
  373.  
  374.  
  375.  
  376.                           Welcome to {COMMO} (tm)                   page 5
  377.  
  378.  
  379.        [Alt-X]   Exit from {COMMO}
  380.        -------   -----------------
  381.        Terminates program, exits back to DOS.  May be pressed from the
  382.        Terminal Screen, Dialing Directory or Macro Processor.
  383.  
  384.  
  385.        [Alt-1]   Capture File Options
  386.        -------   --------------------
  387.        When Capture is OPEN all information written to your screen will be
  388.        saved to the designated disk file.  This command allows you to
  389.        OPEN/CLOSE the Capture File and to change to a different file.  See
  390.        also "Screen Image Save."
  391.  
  392.  
  393.        [Alt-2]   Print Log Toggle
  394.        -------   ----------------
  395.        Turns the Print Log ON/OFF.  When ON all information written to your
  396.        screen will be printed to LPT1.  Handy for getting hard-copy of file
  397.        lists, messages, etc.
  398.  
  399.  
  400.        [Alt-3]   Sound Control Toggle
  401.        -------   --------------------
  402.        Enables/disables all sounds, including alarms and beeps.  Alarms and
  403.        the number of alarm rings are individually configurable in the
  404.        Configuration File and in the Macro File.
  405.  
  406.  
  407.        [Alt-4]   AutoBaud Toggle
  408.        -------   ---------------
  409.        Allows {COMMO} to adjust automatically to the data rate (speed of
  410.        transmission) of the system you are calling.
  411.  
  412.  
  413.        [Alt-5]   Local Echo Toggle
  414.        -------   -----------------
  415.        Used for calling a host system that does not echo what you type. 
  416.        The host must send a linefeed after each carriage return that you
  417.        type.
  418.  
  419.  
  420.        [Alt-0]   Signal Light Toggle
  421.        -------   -------------------
  422.        Turns ON/OFF the "modem lights" display on the status line.  Shows
  423.        the state of the RS-232 signals, including send/receive.
  424.  
  425.  
  426.        [Alt--]   Chat Mode Toggle  (Alt minus)
  427.        -------   ----------------
  428.        Turns Chat Mode ON/OFF.  Split-screen shows received text in the top
  429.        portion and typed text in the bottom portion.  Used for conversing
  430.        with someone at another terminal who is also in Chat Mode.
  431.  
  432.  
  433.  
  434.                           Welcome to {COMMO} (tm)                   page 6
  435.  
  436.  
  437.        [Alt-=]   Doorway Mode Toggle
  438.        -------   -------------------
  439.        Turns Doorway Mode ON/OFF.  Doorway Mode turns off the status line
  440.        providing a 25-line display.  Standard PC keyboard codes are
  441.        transmitted so that you can operate remote applications.
  442.  
  443.  
  444.        The Internal Editor
  445.        -------------------
  446.        {COMMO}'s Internal Editor is easy to use, yet fully functional,
  447.        allowing you to maintain your Configuration File, Dialing Directory
  448.        and Macro File with lines up to 255 characters long.  Full details
  449.        in Online Help.
  450.  
  451.  
  452.        -----------------------
  453.        Uploading / Downloading
  454.        -----------------------
  455.        {COMMO} requires the use of external programs such as Omen
  456.        Technology's DSZ.COM to do protocol transfers of files.  The Macro
  457.        File is pre-configured with macros that execute DSZ to perform
  458.        Xmodem, Ymodem and Zmodem uploads and downloads.  Use the Alt-M key
  459.        command to select one of these macros.
  460.  
  461.        Installing DSZ is very easy.  Just place DSZ.COM in a directory
  462.        which is specified in your DOS path statement.  If you don't have a
  463.        path statement in your AUTOEXEC.BAT file, place DSZ.COM in your
  464.        C:\COMMO directory.  Then type "path c:\commo<cr>" before you call
  465.        {COMMO}.
  466.  
  467.  
  468.        {COMMO} Auto Receive
  469.        --------------------
  470.        Two special macro-id's (see "Programming {COMMO} Macros") are used
  471.        with {COMMO} Auto Receive:
  472.  
  473.                {.z.}   Zmodem AutoDownload
  474.                {.p.}   Puma Auto-Start
  475.  
  476.        Just place the respective macro-id on your Zmodem or Puma receive
  477.        macro and {COMMO} will execute the macro as soon as the sender is
  478.        ready (be patient, a BBS may take several seconds to load and
  479.        execute the protocol program).
  480.  
  481.        IMPORTANT:  Be sure that DSZ.COM or PUMA.EXE are in your DOS path. 
  482.        If not, the message "Bad command or file name" will be periodically
  483.        displayed by DOS.  If this happens type Ctrl-X several times to
  484.        abort the sender.
  485.  
  486.  
  487.  
  488.                           Welcome to {COMMO} (tm)                   page 7
  489.  
  490.  
  491.        ---------------
  492.        Getting Started
  493.        ---------------
  494.  
  495.        First make sure that all of the files from the {COMMO} package are
  496.        in one directory or on one diskette.  Five of these files are
  497.        required to run the {COMMO} program: 
  498.  
  499.             COMMO.COM      the Program File
  500.             COMMO.CFG      the Configuration File
  501.             COMMO.FON      the Dialing Directory File
  502.             COMMO.MAC      the Macro File
  503.             COMMO.HLP      the Online Help File
  504.  
  505.        There are two ways to make sure that {COMMO} will be able to find
  506.        all of its files.  The first method is the simplest and should be
  507.        used if you are not too familiar with DOS commands:
  508.  
  509.        Make sure you are logged into the directory or disk drive where the
  510.        files are located.  Then simply type "commo" at the DOS prompt.  If
  511.        your files are in the directory "C:\COMMO" you would type:
  512.  
  513.                  c:<cr>
  514.                  cd \commo<cr>
  515.                  commo<cr>
  516.  
  517.        (<cr> is the [Enter] or Return key)
  518.  
  519.        Or if the files are on a diskette in drive A you would type:
  520.  
  521.                  a:<cr>
  522.                  commo<cr>
  523.  
  524.        {COMMO} will remember where the files are, so you will be able to
  525.        change directory or drive later without concern.
  526.  
  527.        The second method is a little more advanced, but allows you to run
  528.        {COMMO} no matter what directory or drive you are currently logged
  529.        into:
  530.  
  531.        Use the SET command in DOS to store the {COMMO} path into the
  532.        "environment."  If you place this command in your AUTOEXEC.BAT file
  533.        you won't have to change directories or diskettes to run {COMMO}. 
  534.        If your files are in the directory "C:\COMMO" the command would be:
  535.  
  536.                  set commo=c:\commo
  537.  
  538.        If the files are on the diskette in drive B the command would be:
  539.  
  540.                  set commo=b:
  541.  
  542.        Do not use any extra spaces in the SET command.  And remember to
  543.        place the {COMMO} directory or drive in your PATH command.
  544.  
  545.        IMPORTANT:  Remember to execute the "set commo=" command again if
  546.  
  547.  
  548.  
  549.                           Welcome to {COMMO} (tm)                   page 8
  550.  
  551.  
  552.        you install {COMMO} into a different directory or onto another
  553.        drive.  Otherwise the new copy will refer back to the old directory
  554.        and use the old support files.  This is a common error and can cause
  555.        a lot of head scratching.
  556.  
  557.  
  558.        --------------------
  559.        Command Line Options 
  560.        --------------------
  561.  
  562.          Dialing Strings
  563.          _______________
  564.  
  565.        Dialing Strings may be placed before any command line switches. 
  566.        {COMMO} will search the Dialing Directory for each string and mark
  567.        the first entry where a match is found (case is ignored).
  568.  
  569.        The strings may consist of any part of a Dialing Directory entry
  570.        line and may be separated by commas or spaces.  The following
  571.        characters may not appear in a Dialing String: space, comma, slash
  572.        (/), left or right curly brace.
  573.  
  574.        After entries in the Dialing Directory are marked, {COMMO} will
  575.        check for a Startup Macro (see below).  If no valid macro is present
  576.        Multi Number Dialing of the marked systems will begin.  If a macro
  577.        is present it will be started instead.
  578.  
  579.        The Modem Initialization String will be sent before dialing begins
  580.        unless the switch "/i=no" is present on the command line.
  581.  
  582.        Examples:
  583.  
  584.                 commo telegodzilla joes-bbs 4567 
  585.  
  586.                 commo zilla,joes,4567
  587.  
  588.        IMPORTANT: Your modem should be turned on and ready to receive the
  589.        Modem Initialization String before starting the program.
  590.  
  591.  
  592.          Switches
  593.          ________
  594.  
  595.          /c=filename            default:  COMMO.CFG
  596.  
  597.        Alternate Configuration File.  The alternate file must reside in the
  598.        {COMMO} home directory.
  599.  
  600.          /i=[yes/no]            default:  none
  601.  
  602.        This switch may be used to inhibit the Modem Initialization when
  603.        Dialing Strings and/or a Startup Macro are present: "/i=no."
  604.  
  605.        It may also be used to bypass the question "Initialize modem?" on
  606.        the Initialization Screen: "/i=yes" or "/i=no."
  607.  
  608.  
  609.  
  610.                           Welcome to {COMMO} (tm)                   page 9
  611.  
  612.  
  613.  
  614.          /m=macro-id            default:  none
  615.  
  616.        Startup Macro.  The "macro-id" is a three character macro
  617.        identifier.  If the macro is found in the Macro File it will be
  618.        started.  If the macro is not found the switch will be ignored.
  619.  
  620.        The Modem Initialization String will be sent before starting the
  621.        macro unless the switch "/i=no" is present on the command line. 
  622.  
  623.          /o=bf,bf               default:  17,47
  624.  
  625.        Colors for Initialization Window.  The first field is the text area,
  626.        the second field is the border.  The "bf" is the same format as in
  627.        the Configuration File (see Online Help for details).  Does not
  628.        apply to monochrome displays.
  629.  
  630.  
  631.        Example:
  632.  
  633.                  commo joes zilla /c=other.cfg /m=abc
  634.  
  635.        Two systems will be marked in the Dialing Directory.  The alternate
  636.        Configuration File "other.cfg" will be used (it must be located in
  637.        the {COMMO} home directory).  The macro "abc" will be started if it
  638.        exists in the Macro File.
  639.  
  640.        Note that case is ignored and the order of the switches is
  641.        unimportant (Dialing Strings must be first, however).
  642.  
  643.  
  644.        ---------------------
  645.        {COMMO} Support Files
  646.        ---------------------
  647.  
  648.        The {COMMO} files are standard ASCII text files and may be modified
  649.        with any editor (or word processor in "non-document" mode).  In
  650.        addition all but the Online Help File may be edited with {COMMO}'s
  651.        Internal Editor.
  652.  
  653.        Following is a brief description of each file. 
  654.  
  655.        1) The Configuration File contains settings for many important
  656.           parameters.  When you first run {COMMO} you should use the Alt-G
  657.           key command to edit this file to your own needs.  Save the file
  658.           by pressing [Esc], then "y" or [Enter].  Details for each item in
  659.           this file are given in Online Help.
  660.  
  661.        2) The Dialing Directory File.  This file contains information about
  662.           the systems you will be calling, including the telephone numbers,
  663.           passwords, line parameters and macro link.  Use the Alt-D key
  664.           command to dial numbers and to edit this file.  Details are given
  665.           in Online Help.
  666.  
  667.        3) The Macro File.  Use the Alt-M key command to select a macro for
  668.  
  669.  
  670.  
  671.                           Welcome to {COMMO} (tm)                   page 10
  672.  
  673.  
  674.           execution and to edit this file.  A complete description of
  675.           {COMMO} macros is given in the section "Programming {COMMO}
  676.           Macros" in this document.  A summary of macro functions and key
  677.           designators is given in Online Help.
  678.  
  679.        4) The Online Help File.  Very extensive Online Help is available at
  680.           the touch of a key from within {COMMO}.  In fact most of the
  681.           operating details of the program are ONLY obtained from Online
  682.           Help.  See "How to Use Online Help" later in this document.
  683.  
  684.  
  685.        ------------------------
  686.        Initialization Procedure
  687.        ------------------------
  688.  
  689.        When {COMMO} begins running it will attempt to load the
  690.        Configuration File (default is COMMO.CFG), COMMO.FON and COMMO.MAC. 
  691.  
  692.        Any problems encountered will be reported in the Initialization
  693.        Window.  These problems must be corrected before restarting the
  694.        program.
  695.  
  696.        Automatic modem initialization will occur if Dialing Strings are
  697.        present (and matches are found), or if the Startup Macro Switch is
  698.        present (see "Command Line Options").
  699.  
  700.        Otherwise you will be asked if you want to initialize your modem. 
  701.        Answer "yes" unless you are already on line.
  702.  
  703.        Please note that {COMMO} does NOT change the video display mode. 
  704.        This means simply that the video mode must be set (usually 25 by 80
  705.        color or monochrome) when you call up the program.  This allows you
  706.        to set video parameters such as the screen border color and not have
  707.        them rudely changed when the program is started.
  708.  
  709.        If the display does not look right try executing the DOS command 
  710.        "mode co80" or "mode bw80" prior to calling {COMMO}.
  711.  
  712.  
  713.        ---------------
  714.        Terminal Screen
  715.        ---------------
  716.  
  717.        The Terminal Screen allows you to see the characters coming in from
  718.        the serial port.  Also any characters that you type will be sent to
  719.        the serial port.  If you are connected to another system you will be
  720.        communicating with that system.
  721.  
  722.        From The Terminal Screen you may call upon any of {COMMO}'s features
  723.        by holding the Alt key and pressing a letter or top row number key,
  724.        then releasing both keys.  To see a list of {COMMO} key commands use
  725.        [Alt-H].  To return to The Terminal Screen simply press [Esc].
  726.  
  727.  
  728.  
  729.                           Welcome to {COMMO} (tm)                   page 11
  730.  
  731.  
  732.        ----------------------
  733.        How to Use Online Help
  734.        ----------------------
  735.  
  736.        Most of {COMMO}'s operating details are available as Online Help by
  737.        pressing [Alt-H] from anywhere in the program.  The Online Help
  738.        support file, COMMO.HLP, must be in the {COMMO} home directory or
  739.        you will get an error message, "Unable to open Help file."
  740.  
  741.        This message will also be issued if there is not enough memory
  742.        (approx. 64k) to load the Online Help file.  Note that the file is
  743.        retained in memory until {COMMO} requires memory for some other
  744.        program function.  It will automatically be re-read when necessary. 
  745.  
  746.        Once the Help window is entered you will see the Help control keys
  747.        listed at the bottom of the screen.  At this point you may obtain
  748.        more detailed information on using Online Help by typing "H".
  749.  
  750.  
  751.        -----------------------
  752.        Modifying the Help File
  753.        -----------------------
  754.  
  755.        Once you are familiar with {COMMO} you may wish to reduce the size
  756.        of the Help File.  Feel free to edit this file with an external
  757.        editor -- you can even set up your own menu.  The search keys are
  758.        the bars separating the topics.  The two digit number in the middle
  759.        of the bar may be changed to create your own key.  Remember to keep
  760.        a backup of the original Help File.
  761.  
  762.  
  763.  
  764.                           Welcome to {COMMO} (tm)                   page 12
  765.  
  766.  
  767.        --------------------------
  768.        Programming {COMMO} Macros
  769.        --------------------------
  770.  
  771.        See the sample Macro File, COMMO.MAC, for examples of more complex
  772.        macro programming.
  773.  
  774.        {COMMO} macros may be used to perform many different operations, yet
  775.        their structure is simple and consistent.  Here are some examples:
  776.  
  777.           {alk} {clear} {stop}
  778.  
  779.        This macro will set Alt-K to clear the screen.  "alk" is called a
  780.        "macro identifier" or "macro-id" for short.  It may be any three
  781.        characters.  Certain macro-id's are reserved to represent keys on
  782.        the keyboard, such as "alk" in this case, and are called "key-id's."
  783.  
  784.        CLEAr is called a "function" and is represented by four or more
  785.        characters of which only the first four are necessary.
  786.  
  787.        The STOP function is used here to terminate the macro and may be
  788.        used in either it's long or short form:
  789.  
  790.           ... {stop}          long form
  791.           ... {}              short form
  792.  
  793.        Note that the default key to clear the screen, Alt-C, is still in
  794.        effect unless it is reassigned.
  795.  
  796.        All of {COMMO} key-id's and functions are described in later
  797.        sections.  They are also summarized in Online Help.
  798.  
  799.           {abc}     {setlook 30,hng,3,|} {lookfor first name?}
  800.                     {sendFred|} {}
  801.  
  802.        In this macro the SETLook function will set timeout parameters for
  803.        subsequent LOOKfor functions.  The LOOKfor will then watch the data
  804.        coming in from the modem and when it sees "first name?" it will pass
  805.        control to the next function.  In this case the next function, SEND,
  806.        will send the string "Fred" followed by a carriage return (indicated
  807.        by the "|").  Again the STOP function terminates the macro.
  808.  
  809.           {bbs}     {capture y,commo.cap} {call abc}
  810.                     {asciiup textfile.xyz,:} {}
  811.  
  812.        This macro will open the capture file "commo.cap" (the "y" means
  813.        "yes", open the file).  Then it will execute the previously
  814.        described macro "abc."  Then it will ASCII Upload the file
  815.        "textfile.xyz" using the pacing character ":".
  816.  
  817.        Note that macros may occupy more than one line in the Macro File.
  818.  
  819.  
  820.  
  821.                           Welcome to {COMMO} (tm)                   page 13
  822.  
  823.  
  824.        Macro-id and Function Summary
  825.        -----------------------------
  826.  
  827.        Macro-id's must be three characters (any character that may be
  828.        entered in the Internal Editor is valid).  Case is ignored so that
  829.        "GK1" is the same as "gk1" or "gK1."
  830.  
  831.        Macro-id's may appear anywhere within macros and may be the targets
  832.        of CALL and GOTO functions.  Multiple macro-id's may refer to the
  833.        same macro:
  834.  
  835.           {aln} {aly} {dial 50,abc} {}.
  836.  
  837.        Two macro-id's are reserved for {COMMO}'s Auto Receive feature:
  838.  
  839.                {.z.}     Zmodem AutoDownload
  840.                {.p.}     Puma Auto-Start
  841.  
  842.        Simply place the respective macro-id on the Zmodem or Puma receive
  843.        macro and the macro will be started automatically.  Auto Receive
  844.        operations are not available when a macro is running -- use a RETUrn
  845.        at the end of the macro and execute it with a CALL.
  846.  
  847.        Function names are four or more characters and may always be
  848.        abbreviated to the first four.  Case is ignored here as well.
  849.  
  850.        Remember to terminate each macro with a STOP function unless it
  851.        already ends with a GOTO or RETUrn.  If you don't, processing will
  852.        continue with the next macro in your Macro File!
  853.  
  854.  
  855.        Additional Macro File Rules
  856.        ---------------------------
  857.  
  858.        The Macro File is entirely free-form.  Macro-id's and functions may
  859.        appear on the same line or on separate lines.  More that one
  860.        macro-id may appear on the same line (only the first may be executed
  861.        from the Macro File window using the Selector Bar):
  862.  
  863.           {ala} {clear} {}    {alw} {sound n} {}
  864.  
  865.        Comments may appear anywhere outside the curly braces.
  866.  
  867.  
  868.        Executing Macros
  869.        ----------------
  870.  
  871.        Macro execution may be started in a number of ways:
  872.  
  873.        1) Open the Macro Processor window (Alt-M), position the Selector
  874.           Bar on the macro-id and press [Enter] (the macro-id must be the
  875.           first string on the line).
  876.  
  877.        2) If the macro-id is also a key-id, then you may press that key
  878.           from the Terminal Screen.  If the same key-id is used more than
  879.  
  880.  
  881.  
  882.                           Welcome to {COMMO} (tm)                   page 14
  883.  
  884.  
  885.           once, the first occurrence will be used.
  886.  
  887.        3) The macro may be linked to a Dialing Directory entry.  In this
  888.           case it will be CALLed when a connection is established with that
  889.           system.
  890.  
  891.        4) The macro may be specified on the command line with the switch
  892.           "/m=".  It will be started as soon as {COMMO} has initialized
  893.           itself.
  894.  
  895.        5) The macro may be an argument of another function such as CALL,
  896.           GOTO, DIAL or SETLook (these are detailed in a later section).
  897.  
  898.  
  899.        Additional Macro Execution Rules
  900.        --------------------------------
  901.  
  902.        ASCII keys may be typed to the serial port during LOOKfor, PAUSe and
  903.        HOLD functions.  To send an Esc code press Ctrl [ (Ctrl + left
  904.        bracket).
  905.  
  906.        The Macro Processor will execute functions in order until one of the
  907.        following conditions occur:
  908.  
  909.        1) A CALL, GOTO, RETURn, STOP or EXIT is encountered.
  910.  
  911.        2) Control is transferred to an alternate macro from certain
  912.           functions when a special condition occurs.  An example of this is
  913.           the SETLook function.  The alternate will execute when a
  914.           subsequent LOOKfor times out.
  915.  
  916.        3) The end of the Macro File is reached.
  917.  
  918.        Current function execution may be terminated by pressing [Esc].  For
  919.        example, to terminate a PAUSe or HOLD prematurely.
  920.  
  921.        Overall macro execution may be terminated by pressing [Ctrl-Break]. 
  922.        This will issue an [Esc] to the currently executing function, then
  923.        terminate macro processing and return you to the Terminal Screen.
  924.  
  925.        Macro errors will also terminate macro execution and bring up the
  926.        Macro Error window, indicating the location of the problem.
  927.  
  928.        Some macro functions show their current action on the status line at
  929.        the bottom of the screen.  In addition, a "face" character in the
  930.        middle of the status line indicates that a macro is executing.
  931.  
  932.  
  933.  
  934.                           Welcome to {COMMO} (tm)                   page 15
  935.  
  936.  
  937.        -----------------------
  938.        {COMMO} Macro Functions
  939.        -----------------------
  940.  
  941.        The purpose of this section is to show the syntax of each function
  942.        and the meaning of its arguments through examples.  Details on
  943.        functions which are also default key commands may be found in Online
  944.        Help.  Other functions will be explained in this section.
  945.  
  946.        Function names are shown with their four-letter abbreviations in
  947.        uppercase.  The following conventions are used in many functions:
  948.  
  949.           "y" or "yes" is used to indicate "yes", "on",  "open",  etc.
  950.           "n" or "no"  is used to indicate "no",  "off", "close", etc.
  951.  
  952.        This provides a highly consistent macro structure which is very easy
  953.        to remember.  When a function is also associated with a default key
  954.        command, the lack of arguments will cause the function to behave
  955.        like the key command -- bringing up a window, for example.
  956.  
  957.  
  958.        Function Arguments
  959.        ------------------
  960.        Arguments are the parameters that follow the function name.  One
  961.        space separates the function name from the arguments (extra spaces
  962.        should be avoided).  Multiple arguments are separated by commas.  
  963.         
  964.           {bbs}     {capture y,commo.cap} {call abc}
  965.                     {asciiup textfile.xyz,:} {return}
  966.  
  967.        Here the function CAPTure has two arguments: "y" and "commo.cap."
  968.  
  969.           {abc} {lookfor first name?} {send Fred|} {}
  970.  
  971.        The function LOOKfor has one argument: "first name?".  Quotation
  972.        marks are NOT used to enclose data strings or filenames in {COMMO}
  973.        macros.
  974.  
  975.  
  976.  
  977.                           Welcome to {COMMO} (tm)                   page 16
  978.  
  979.  
  980.        ALARm
  981.        -----
  982.        Default key: none
  983.        Description: Ring the alarm
  984.  
  985.        Examples:
  986.  
  987.           {alarm}             Ring alarm, ring count in Config. File
  988.           {alarm 2}           Ring alarm 2 times
  989.  
  990.  
  991.        ASCIiup      
  992.        -------
  993.        Default key: Alt-A       
  994.        Description: Upload an ASCII (text) file
  995.  
  996.        Examples:    
  997.  
  998.           {asci}              Open ASCII Upload window
  999.  
  1000.           {asci file.xyz,:}   Upload "file.xyz."  Use ":" for pacing
  1001.  
  1002.           {asci file.xyz}     Same, but use current pacing character
  1003.  
  1004.           {asci file.xyz,}    Same, but no pacing
  1005.  
  1006.           {asci ,?}           Set current pacing character to "?"
  1007.  
  1008.           {asci ,}            Set current pacing to "no" pacing
  1009.  
  1010.        The pacing character may be entered according to the rules in
  1011.        Appendix D "ASCII Character Representation."  For example, "^m" or
  1012.        "|" may be used to represent the carriage return.
  1013.  
  1014.  
  1015.        AUTObaud
  1016.        --------
  1017.        Default key: Alt-5
  1018.        Description: Set AutoBaud toggle
  1019.  
  1020.        Examples:
  1021.  
  1022.           {auto}              Toggle AutoBaud on/off
  1023.           {auto y}            Turn on AutoBaud     
  1024.           {auto n}            Turn off AutoBaud
  1025.  
  1026.  
  1027.        BEEP
  1028.        ----
  1029.        Default key: none
  1030.        Description: Sound a beep
  1031.  
  1032.        Examples:
  1033.  
  1034.           {beep}              No arguments
  1035.  
  1036.  
  1037.  
  1038.                           Welcome to {COMMO} (tm)                   page 17
  1039.  
  1040.  
  1041.        BREAk
  1042.        -----
  1043.        Default key: Alt-B
  1044.        Description: Send a break
  1045.  
  1046.        Example:
  1047.  
  1048.           {break}             No arguments
  1049.  
  1050.  
  1051.        CALL
  1052.        ----
  1053.        Default key: none
  1054.        Description: Execute another macro
  1055.  
  1056.        Example:
  1057.  
  1058.           {call abc}          Execute macro abc
  1059.  
  1060.        If the macro "abc" executes a RETUrn function, then control returns
  1061.        to the function following the CALL.
  1062.  
  1063.        Note that macros may be nested up to 32 deep.
  1064.  
  1065.  
  1066.        CAPTure
  1067.        -------
  1068.        Default key: Alt-1
  1069.        Description: Capture File Options
  1070.  
  1071.        Examples:
  1072.  
  1073.           {capture}                     Open Capture File Options window
  1074.  
  1075.           {capture y}                   Open current Capture File
  1076.  
  1077.           {capture n}                   Close current Capture File
  1078.  
  1079.           {capt y,c:\commo\file.xyz}    Open indicated Capture File
  1080.  
  1081.           {capt n,c:\dl\newfile.cap}    Close current Capture File, set new 
  1082.                                         file as indicated
  1083.  
  1084.  
  1085.        CHATmode
  1086.        --------
  1087.        Default key: Alt-- (Alt minus)
  1088.        Description: Set Chat Mode toggle
  1089.  
  1090.        Examples:
  1091.  
  1092.           {chat}              Toggle Chat Mode on/off
  1093.           {chat y}            Turn on Chat Mode
  1094.           {chat n}            Turn off Chat Mode
  1095.  
  1096.  
  1097.  
  1098.                           Welcome to {COMMO} (tm)                   page 18
  1099.  
  1100.  
  1101.        CLEAr
  1102.        -----
  1103.        Default key: Alt-C
  1104.        Description: Clear Terminal Screen to default colors
  1105.  
  1106.        Example:
  1107.  
  1108.           {clear}             No arguments
  1109.  
  1110.  
  1111.        CONFig
  1112.        ------
  1113.        Default key: Alt-G
  1114.        Description: Edit Configuration File
  1115.  
  1116.        Example:
  1117.  
  1118.           {config}            No arguments
  1119.  
  1120.  
  1121.        DIAL
  1122.        ----
  1123.        Default key: Alt-D, Alt-U
  1124.        Description: Dialing Directory
  1125.  
  1126.        Examples:
  1127.  
  1128.           {dial}              Open Dialing Directory window (like Alt-D)
  1129.  
  1130.           {dial ,}            Multi Number Dial (like Alt-U)
  1131.  
  1132.           {dial 25,abc}       Multi Number dial with try count
  1133.  
  1134.        25      Maximum number of dialing tries.  If no connection is
  1135.                established when the try count is exhausted, the macro in
  1136.                the second argument will be started.  May be 0 to 999.  "0"
  1137.                means unlimited.  
  1138.  
  1139.        abc     Macro to GOTO if the try count in the first argument is
  1140.                exhausted.  If no macro is specified or if the macro-id is
  1141.                invalid, control will pass to the next function.
  1142.  
  1143.        Default arguments are:    Dialing tries   0 (unlimited)
  1144.                                  Macro           none 
  1145.  
  1146.        Null arguments in the DIAL function will revert to these defaults.
  1147.  
  1148.  
  1149.        Marked numbers will be redialed in sequence.  Numbers may be marked
  1150.        in several ways:
  1151.  
  1152.           1)   Manually in the Dialing Directory window.
  1153.           2)   By placing Dialing Strings on the command line.
  1154.           3)   Using the MARK macro function.
  1155.  
  1156.  
  1157.  
  1158.                           Welcome to {COMMO} (tm)                   page 19
  1159.  
  1160.  
  1161.        If a connection occurs there are two possibilities:
  1162.  
  1163.           1)   If a valid macro is specified in the Dialing Directory, that
  1164.                macro will be started.  When a RETUrn function is
  1165.                encountered {COMMO} will continue dialing other numbers if
  1166.                any are marked.  When no more marked numbers are found,
  1167.                control returns following the DIAL function.
  1168.  
  1169.                This allows more than one system to be called automatically. 
  1170.                Use a {stop} or {} at the end of the macro to begin manual
  1171.                operation.  At the end of the call press Alt-U to continue
  1172.                Multi Number Dialing.
  1173.  
  1174.           2)   If no macro is specified in the Dialing Directory, control
  1175.                is returned to the Terminal Screen and macro processing is
  1176.                terminated.
  1177.  
  1178.  
  1179.        See also the functions: MARK, UNMArk.
  1180.  
  1181.  
  1182.        EXECute
  1183.        -------
  1184.        Default key: none
  1185.        Description: Execute a DOS command
  1186.  
  1187.        A number of special parameters are available to the EXECute function
  1188.        which will either substitute the current value of a variable or
  1189.        perform a specific action before/after command execution:
  1190.  
  1191.           %i   general user Input prompt
  1192.           %p   current serial Port no. (1,2,3 or 4)
  1193.           %s   current Speed (1200, 2400, etc.)
  1194.           %u   current Upload directory (from Config)
  1195.           %d   current Download directory (from Config)
  1196.           %c   current Capture file (use Alt-1 to check)
  1197.           %a   sound Alarm at end of command execution
  1198.           %w   Wait (pause) before returning to Terminal Screen
  1199.           %%   insert an actual "%" into the command
  1200.  
  1201.        "%i" may be used more than once in a command and will result in a
  1202.        prompt for input in the EXECute DOS Command window.  This is an
  1203.        opportunity to enter a filename or any other information pertinent
  1204.        to the execution of the command.
  1205.  
  1206.        "%w" causes a wait before restoring the Terminal Screen.  This is
  1207.        useful if you need to see the results of the command execution.
  1208.  
  1209.        A wait before and after each EXECute function may be forced by
  1210.        starting a macro with [Ctrl-Enter] instead of [Enter] (from the
  1211.        Macro Processor window only).
  1212.  
  1213.        Examples:
  1214.  
  1215.           {exec dsz port %p speed %s sz %u\%i %a%w}
  1216.  
  1217.  
  1218.  
  1219.                           Welcome to {COMMO} (tm)                   page 20
  1220.  
  1221.  
  1222.  
  1223.           {COMMO} will prepare the DSZ command by substituting the "%"
  1224.           parameters, then call DOS to execute the program.  The alarm will
  1225.           sound at completion and {COMMO} will wait for a keypress before
  1226.           resuming.
  1227.  
  1228.           {exec list %c}
  1229.  
  1230.           The LIST program will be executed with the current Capture File
  1231.           as a command line argument.  {COMMO} will return immediately to
  1232.           the Terminal Screen when LIST exits.
  1233.  
  1234.  
  1235.        EXEN
  1236.        ----
  1237.        Default key: none
  1238.        Description: Execute a DOS command, do not clear the screen
  1239.  
  1240.        This function is exactly the same as EXECute, but the Terminal
  1241.        Screen is not cleared when the command is sent to DOS.  It is used
  1242.        to prevent the screen from "flickering" when programs or DOS
  1243.        commands execute rapidly.
  1244.  
  1245.        Examples:
  1246.  
  1247.           {exen del c:\commo\commo.cap}
  1248.           {exen ren commo.cap joes-bbs.cap}
  1249.  
  1250.  
  1251.        EXIT
  1252.        ----
  1253.        Default key: Alt-X
  1254.        Description: Exit {COMMO}
  1255.  
  1256.        Example:
  1257.  
  1258.           {exit}              No arguments
  1259.  
  1260.  
  1261.        GOTO
  1262.        ----
  1263.        Default key: none
  1264.        Description: Transfer control to a macro-id
  1265.  
  1266.        Example:
  1267.  
  1268.           {goto x21}          Control transferred to "x21"
  1269.  
  1270.  
  1271.  
  1272.                           Welcome to {COMMO} (tm)                   page 21
  1273.  
  1274.  
  1275.        HANGup
  1276.        ------
  1277.        Default key: Alt-Q
  1278.        Description: Disconnect by dropping DTR
  1279.  
  1280.        Examples:
  1281.  
  1282.           {hangup}            Prompt user for disconnect
  1283.           {hangup y}          Disconnect without prompting
  1284.  
  1285.  
  1286.        HELP
  1287.        ----
  1288.        Default key: Alt-H
  1289.        Description: Open Online Help window
  1290.  
  1291.        Example:
  1292.  
  1293.           {help}              No arguments
  1294.  
  1295.  
  1296.        HOLD
  1297.        ----
  1298.        Default key: none
  1299.        Description: Hold until specified time of day (24 hour format)
  1300.  
  1301.        Examples:
  1302.  
  1303.           {hold 3:30}         Hold until 3:30 am
  1304.           {hold 16:10}        Hold until 4:10 pm
  1305.           {hold 0:00}         Hold until midnight
  1306.  
  1307.  
  1308.        INITmodem
  1309.        ---------
  1310.        Default key: Alt-O
  1311.        Description: Send Modem Initialization String
  1312.  
  1313.        Example:
  1314.  
  1315.           {init}              No arguments
  1316.  
  1317.  
  1318.        LIGHts
  1319.        ------
  1320.        Default key: Alt-0
  1321.        Description: Set Signal Lights toggle
  1322.  
  1323.        Examples:
  1324.  
  1325.           {lights}            Toggle Signal Lights on/off
  1326.           {lights y}          Turn on Signal Lights
  1327.           {lights n}          Turn off Signal Lights
  1328.  
  1329.  
  1330.  
  1331.                           Welcome to {COMMO} (tm)                   page 22
  1332.  
  1333.  
  1334.        LOCAlecho
  1335.        ---------
  1336.        Default key: Alt-6
  1337.        Description: Set Local Echo toggle
  1338.  
  1339.        Examples:
  1340.  
  1341.           {local}             Toggle Local Echo on/off
  1342.           {local y}           Turn on Local Echo
  1343.           {local n}           Turn off Local Echo
  1344.  
  1345.  
  1346.        LOOKfor
  1347.        -------
  1348.        Default key: none
  1349.        Description: Look for a string in the modem input stream
  1350.  
  1351.        Examples:
  1352.  
  1353.           {setlook 60,abc,4,n|}    Set parameters
  1354.           {lookfor first name?}    Look for the string "first name?"
  1355.           {look ^(COMMO^)}         Look for the string "{COMMO}"
  1356.  
  1357.  
  1358.        Parameters controlling LOOKfor execution are set with the SETLook
  1359.        function, which should be executed before any LOOKfor functions. 
  1360.        See description of SETLook function for details.
  1361.  
  1362.        The LOOKfor function will watch for the requested string to appear,
  1363.        then macro execution will continue with the next function.
  1364.  
  1365.        Case will be ignored and ANSI control sequences will be stripped (if
  1366.        ANSI emulation is enabled).  Thus you needn't be concerned about
  1367.        remembering if any characters were upper or lower case, nor do you
  1368.        have to tell the remote to turn off ANSI graphics. 
  1369.  
  1370.        Note that there are special rules for representing characters in
  1371.        LOOKfor strings.  See Appendix D "ASCII Character Representation"
  1372.        for details.
  1373.  
  1374.  
  1375.        MACRo
  1376.        -----
  1377.        Default key: Alt-M
  1378.        Description: Open Macro Processor window
  1379.  
  1380.        Example:
  1381.  
  1382.           {macro}             no arguments
  1383.  
  1384.  
  1385.  
  1386.                           Welcome to {COMMO} (tm)                   page 23
  1387.  
  1388.  
  1389.        MARK
  1390.        ----
  1391.        Default key: none
  1392.        Description: Mark Dialing Directory entries for dialing
  1393.  
  1394.        Example:
  1395.  
  1396.           {mark joes-bbs,file-city}     Mark entries for dialing
  1397.  
  1398.        Dialing Strings may be separated by spaces or commas.
  1399.  
  1400.        {COMMO} will search the Dialing Directory for each string and mark
  1401.        the first entry where a match is found.  Case is ignored.
  1402.  
  1403.        The strings may consist of any part of a Dialing Directory entry
  1404.        line.  However the following characters may not appear in a dialing
  1405.        string: space, comma, slash (/), left or right curly brace. 
  1406.  
  1407.        See also the functions: DIAL, UNMArk.
  1408.  
  1409.  
  1410.        NOOP
  1411.        ----
  1412.        Default key: none
  1413.        Description: No-op function, does nothing
  1414.  
  1415.        Example:
  1416.  
  1417.           {noop}              no arguments
  1418.  
  1419.  
  1420.        PARMs
  1421.        -----
  1422.        Default key: Alt-L
  1423.        Description: Set Terminal Parameters
  1424.  
  1425.        Examples:
  1426.  
  1427.           {parms 2,2400,8,V}       Set Com2, 2400 bps, 8,n,1, VT102
  1428.  
  1429.           {parms ,9600}            Set 9600 bps
  1430.  
  1431.           {parms 1,19200,7}        Set Com1, 19200 bps, 7,e,1
  1432.  
  1433.           {parms ,,,a}             Set ANSI-BBS
  1434.  
  1435.  
  1436.  
  1437.                           Welcome to {COMMO} (tm)                   page 24
  1438.  
  1439.  
  1440.        PASSword
  1441.        --------
  1442.        Default key: Alt-P
  1443.        Description: Send current password
  1444.  
  1445.        Example:
  1446.  
  1447.           {password}          No arguments
  1448.  
  1449.        The current password is obtained from the Dialing Directory entry
  1450.        whenever a number is dialed.  If no password is specified no
  1451.        characters will be sent.
  1452.  
  1453.  
  1454.        PAUSe
  1455.        -----
  1456.        Default key: none
  1457.        Description: Pause for up to 999 seconds
  1458.  
  1459.        Example:
  1460.  
  1461.           {pause 25}          Pause for 25 seconds
  1462.  
  1463.  
  1464.        PRINtlog
  1465.        --------
  1466.        Default key: Alt-2
  1467.        Description: Set Print Log toggle
  1468.  
  1469.        Examples:
  1470.  
  1471.           {print}             Toggle Print Log on/off
  1472.           {print y}           Turn on Print Log     
  1473.           {print n}           Turn off Print Log
  1474.  
  1475.  
  1476.        RETUrn
  1477.        ------
  1478.        Default key: none
  1479.        Description: Return from a CALLed macro
  1480.  
  1481.        Example:
  1482.  
  1483.           {return}            no arguments
  1484.  
  1485.        This function is used in the following situations:
  1486.  
  1487.           1)   To end a macro started by a CALL.  Control returns following
  1488.                the CALL function.
  1489.  
  1490.           2)   To end a Dialing Directory macro.  If dialing was initiated
  1491.                from a DIAL macro function, dialing will continue if any
  1492.                more numbers are marked.  If no more numbers are marked,
  1493.                then control will pass to the function following DIAL.
  1494.  
  1495.  
  1496.  
  1497.                           Welcome to {COMMO} (tm)                   page 25
  1498.  
  1499.  
  1500.        Note: If a RETUrn is encountered and no CALL has been executed, a
  1501.        STOP will occur.  This is useful in macros that are CALLed and are
  1502.        also used standalone (such as protocol file transfer macros).
  1503.  
  1504.  
  1505.        SCREen
  1506.        ------
  1507.        Default key: Alt-I
  1508.        Description: Screen Image Save
  1509.  
  1510.        Examples:
  1511.  
  1512.           {screen}                 Open Screen Image Save window
  1513.           {screen y}               Append screen image to current file 
  1514.           {screen y,commo.scn}     Append screen image to indicated file
  1515.                                     (and change current pathname) 
  1516.           {screen n,c:\file.xyz}   Change current screen image pathname
  1517.                                     (don't save screen to file)
  1518.  
  1519.        SEND
  1520.        ----
  1521.        Default key: none
  1522.        Description: Send a string to the modem
  1523.  
  1524.        Example:
  1525.  
  1526.           {send Fred|~~Brucker|~~#|}    Send my first and last name with
  1527.                                         carriage returns and 1 second
  1528.                                         delays, then send the current
  1529.                                         password and <cr>.
  1530.  
  1531.        Note: see Appendix D "ASCII Character Representation" for
  1532.        information on how to represent any character in a SEND function.
  1533.  
  1534.  
  1535.        SETLook
  1536.        -------
  1537.        Default key: none
  1538.        Description: Set parameters for LOOKfor functions
  1539.  
  1540.        Example:
  1541.  
  1542.           {setl 60,abc,4,n|}       Set LOOKfor parameters
  1543.  
  1544.        60      LOOKfor timeout.  Maximum time in seconds to look for a
  1545.                string.  If the string is not found in the allotted time,
  1546.                the macro in the second argument will be started.  May be 0
  1547.                to 999.  "0" means forever.  
  1548.  
  1549.        abc     Timeout macro.  Macro to GOTO if the time in the first
  1550.                argument expires.  If no macro is specified or if the
  1551.                macro-id is invalid, control will pass to the next function.
  1552.  
  1553.        4       Prompt timeout.  During a LOOKfor function unwanted prompts
  1554.                may appear like "Press any key" or "More [Y/n]", etc.  
  1555.  
  1556.  
  1557.  
  1558.                           Welcome to {COMMO} (tm)                   page 26
  1559.  
  1560.  
  1561.                This argument is the time in seconds to wait at a prompt (no
  1562.                input from the modem) before sending the string in the
  1563.                fourth argument.  Usually you would send "|" or "n|".
  1564.  
  1565.                When the string is sent the process is restarted, allowing
  1566.                any number of prompts to be satisfied (until the LOOKfor
  1567.                itself is satisfied or times out).
  1568.  
  1569.                Make sure this value is high enough to give the host system
  1570.                time to "think" when it is in between prompts.  Some systems
  1571.                take longer to do things.  May be 0 to 999.  "0" means
  1572.                forever.
  1573.  
  1574.        n|      Prompt response.  String to send when the time in the third
  1575.                argument runs out.
  1576.  
  1577.        The SETLook function will set parameters for any subsequent
  1578.        LOOKfor's.  SETLook may be executed at any time to modify the
  1579.        parameters.
  1580.  
  1581.        Default arguments are:      LOOKfor timeout  0 seconds
  1582.                                    Timeout macro    none 
  1583.                                    Prompt timeout   0 seconds
  1584.                                    Prompt response  none
  1585.  
  1586.        Null arguments in the SETLook function will revert to these
  1587.        defaults.
  1588.  
  1589.  
  1590.        SHELl
  1591.        -----
  1592.        Default key: Alt-S
  1593.        Description: Shell to DOS
  1594.  
  1595.        Example:
  1596.  
  1597.           {shell}             No arguments
  1598.  
  1599.  
  1600.        SOUNd
  1601.        -----
  1602.        Default key: Alt-3
  1603.        Description: Set Master Sound toggle
  1604.  
  1605.        Examples:
  1606.  
  1607.           {sound}             Toggle Master Sound on/off
  1608.           {sound y}           Turn on Master Sound
  1609.           {sound n}           Turn off Master Sound
  1610.  
  1611.  
  1612.  
  1613.                           Welcome to {COMMO} (tm)                   page 27
  1614.  
  1615.  
  1616.        STOP
  1617.        ----
  1618.        Default key: none
  1619.        Description: Halt macro execution
  1620.  
  1621.        Examples:
  1622.  
  1623.           {stop}              No arguments
  1624.           {}                  Short form
  1625.  
  1626.        STOP always returns {COMMO} to manual operation in the Terminal
  1627.        Screen.  It should be used to end login macros.
  1628.  
  1629.  
  1630.        UNMArk
  1631.        ------
  1632.        Default key: none
  1633.        Description: Unmark all entries marked for dialing in the Dialing
  1634.                     Directory
  1635.  
  1636.        Example:
  1637.  
  1638.           {unmark}            No arguments
  1639.  
  1640.        See also the functions: DIAL, MARK.
  1641.  
  1642.  
  1643.        VTCUr
  1644.        -----
  1645.        Default key: none
  1646.        Description: Define a VT102 cursor (arrow) key
  1647.  
  1648.        Example:
  1649.  
  1650.           {vtcur ^[[A|^[OA}        Define up-arrow key strings
  1651.  
  1652.        The first string is sent when cursor mode is active; the second
  1653.        string is sent when application mode is active (these modes are
  1654.        controlled by the host).
  1655.  
  1656.        The two strings must be separated by a "|".  Use "^m" for carriage
  1657.        return if necessary.
  1658.  
  1659.  
  1660.  
  1661.                           Welcome to {COMMO} (tm)                   page 28
  1662.  
  1663.  
  1664.        VTPAd
  1665.        -----
  1666.        Default key: none
  1667.        Description: Define a VT102 keypad key
  1668.  
  1669.        Example:
  1670.  
  1671.           {vtpad 5|^[Ou}           Define keypad "5" key strings
  1672.  
  1673.        The first string is sent when numeric mode is active; the second
  1674.        string is sent when application mode is active (these modes are
  1675.        controlled by the host).
  1676.  
  1677.        The two strings must be separated by a "|".  Use "^m" for carriage
  1678.        return if necessary.
  1679.  
  1680.  
  1681.  
  1682.                           Welcome to {COMMO} (tm)                   page 29
  1683.  
  1684.  
  1685.        -------------------------
  1686.        Table of {COMMO} Key-id's
  1687.        -------------------------
  1688.  
  1689.        Key-id's are also macro-id's with the added advantage that the macro
  1690.        can be started by pressing the associated key from the Terminal
  1691.        Screen.  Most "special" keys may be assigned this way.  If the same
  1692.        key-id appears more than once, the first occurrence will be used. 
  1693.        Note that key-id's are case insensitive.  The caret (^) indicates
  1694.        the Ctrl key.
  1695.  
  1696.  
  1697.                Key Name     Key-id        Key Name     Key-id
  1698.                ________     ______        ________     ______
  1699.  
  1700.                Normal-F1     nf1   ...    Normal-F10    nf0
  1701.                Ctrl-F1       cf1   ...    Ctrl-F10      cf0
  1702.                Shift-F1      sf1   ...    Shift-F10     sf0
  1703.                Alt-F1        af1   ...    Alt-F10       af0
  1704.  
  1705.                Alt-A         ala   ...    Alt-Z         alz
  1706.                Alt-1         al1   ...    Alt-0         al0
  1707.                Alt =         al=          Alt -         al-
  1708.  
  1709.                Escape        esc          Grey *        gr*
  1710.                Grey -        gr-          Grey +        gr+
  1711.  
  1712.                Backspace     bsp          ^Backspace    cbs
  1713.                Tab           tab          Shift-tab     stb
  1714.                Enter         ent          ^Enter        cen
  1715.  
  1716.                Home          hom          End           end
  1717.                PgUp          pgu          PgDn          pgd
  1718.                Up-Arrow      upa          Down-Arrow    dna
  1719.                Left-Arrow    lfa          Right-Arrow   rta
  1720.                Insert        ins          Delete        del
  1721.  
  1722.                ^Home         chm          ^End          cnd
  1723.                ^PgUp         cpu          ^PgDn         cpd
  1724.                ^Right-Arrow  cra          ^Left-Arrow   cla
  1725.  
  1726.                Keypad-0      kp0   ...    Keypad-9      kp9
  1727.                Keypad-.      kp.          ^PrtSc        cpr
  1728.  
  1729.  
  1730.  
  1731.                           Welcome to {COMMO} (tm)                   page 30
  1732.  
  1733.  
  1734.        ----------   ---------------------
  1735.        Appendix A   Setting Up Your Modem
  1736.        ----------   ---------------------
  1737.  
  1738.        Please be aware that there are many different modems in use and that
  1739.        it is of the utmost importance that you configure your modem to work
  1740.        correctly with {COMMO}.  A few tips will be given here, but they are
  1741.        no substitute for the detailed installation instructions in your
  1742.        modem manual!
  1743.  
  1744.        When {COMMO} is started a command string will be sent to the modem
  1745.        called the Modem Initialization String.  You must make certain that
  1746.        the correct string is set up in your Configuration File (Item 4). 
  1747.        This string will perform part or all of the modem setup depending on
  1748.        the type of modem.  Examples will be given for the most common
  1749.        types.
  1750.  
  1751.        If your modem is external to your computer, be sure you have
  1752.        followed the installation instructions carefully and that the cable
  1753.        is connected to the computer's serial port.  It is wise to turn off
  1754.        power to the computer and the modem when connecting or disconnecting
  1755.        any cables.
  1756.  
  1757.        Note the number of the serial port that you have used -- Com1, Com2,
  1758.        ... , etc.  The numeric part of the serial port number (1, 2, ... )
  1759.        must be placed in Item 1 of the Configuration File.  Also check the
  1760.        default speed in Item 2.
  1761.  
  1762.        1200 bps Modems
  1763.        _______________
  1764.  
  1765.        Most 1200 bps modems have switches on them which must be set to
  1766.        provide the proper interaction with your computer and with {COMMO}. 
  1767.        Consult your modem manual concerning these switches and pay
  1768.        particular attention to the following:
  1769.  
  1770.           1)   Enable command recognition.  Allows the modem to recognize
  1771.                commands (dial, set registers, etc.).  Must be in the
  1772.                "enable" position or modem will be unusable.
  1773.  
  1774.           2)   Send result codes in English.  This switch should be set so
  1775.                that the modem will send verbal responses to commands
  1776.                instead of numbers.  This is usually controlled by a command
  1777.                also (such as ATV1).
  1778.  
  1779.           3)   Respond to DTR (data terminal ready).  This should NOT be in
  1780.                the "ignore" position.  This switch allows the computer to
  1781.                signal the modem to hang up.
  1782.  
  1783.           4)   Force carrier detect.  This switch should be set to "respond
  1784.                to carrier detect" or "allow true carrier."
  1785.  
  1786.        Here is an example modem initialization string (Configuration File
  1787.        Item 4) which will set up a 1200 bps modem and override the switch
  1788.        settings (if possible):
  1789.  
  1790.  
  1791.  
  1792.                           Welcome to {COMMO} (tm)                   page 31
  1793.  
  1794.  
  1795.  
  1796.           4 * {AT S0=0 S7=60 E0 Q0 V1 X1 |}   Modem init string     
  1797.  
  1798.        The most important command is the "X" command, since its function
  1799.        varies the most from modem to modem.  The "X" command determines
  1800.        which responses the modem will generate during dialing (e.g.
  1801.        CONNECT, BUSY, etc.).  It may also activate an additional modem
  1802.        feature such as automatic redialing which will interfere with
  1803.        {COMMO}'s own redialing procedure.
  1804.  
  1805.        Your modem manual gives a description for each level of the "X"
  1806.        command: X0, X1, X2, ... , etc.  Generally you want to use the
  1807.        highest level that does not activate undesirable features.  If you
  1808.        will be using {COMMO}'s AutoBaud feature you will need the extended
  1809.        connect responses such as CONNECT 1200.  Also the BUSY response
  1810.        should be provided if possible.  In any case you should modify the
  1811.        Modem Initialization String to work with your particular modem.
  1812.  
  1813.        2400 bps and higher
  1814.        ___________________
  1815.  
  1816.        Modems which operate at 2400 bps and higher generally have commands
  1817.        to replace the switches.  These commands may be given every time you
  1818.        start {COMMO} or they may be permanently remembered by modems which
  1819.        have "non-volatile" memory.
  1820.  
  1821.        It will be assumed here that the commands are given every time you
  1822.        start {COMMO}.  If you wish to place the settings in non-volatile
  1823.        memory, consult your modem manual on how to do this.  Here is an
  1824.        example initialization string for 2400 bps (and higher) modems:
  1825.  
  1826.           4 * {AT S0=0 S7=60 E0 Q0 V1 X4 &C1 &D2 |}   Modem init string  
  1827.  
  1828.        See the comments above concerning the "X" command since they apply
  1829.        to these modems as well.
  1830.  
  1831.  
  1832.        If {COMMO} is already running you may edit the Configuration File
  1833.        with the Alt-G key command, change the modem initialization string 
  1834.        (save the file), then use the Alt-O key command to send the string
  1835.        to the modem.  Normally the string is sent to the modem when {COMMO}
  1836.        is started.
  1837.  
  1838.  
  1839.  
  1840.                           Welcome to {COMMO} (tm)                   page 32
  1841.  
  1842.  
  1843.        ----------   -------------------------
  1844.        Appendix B   {COMMO} and Multi-Tasking
  1845.        ----------   -------------------------
  1846.  
  1847.        DESQview
  1848.        --------
  1849.  
  1850.        Special care has been taken to insure that {COMMO} is compatible
  1851.        with Quarterdeck Office Systems' DESQview(tm), a multi-tasking
  1852.        supervisor.  DESQview allows more than one program to execute at the
  1853.        same time.
  1854.  
  1855.        A sample Program Information File (CO-PIF.DVP) has been included in
  1856.        the {COMMO} package for your convenience.  This file has been set up
  1857.        to define a 120k memory window, allowing DSZ and LIST to be run from
  1858.        the Macro Processor.
  1859.  
  1860.        If a DOS command (or program run from the Shell to DOS) will not
  1861.        execute due to insufficient memory, this number will have to be
  1862.        increased.  Be sure to test DOS commands with a "wait" at the end so
  1863.        that you can see any error messages (see EXEC function).
  1864.  
  1865.        You may be able to make this window smaller by reducing the size of
  1866.        {COMMO}'s support files and/or by running smaller programs with
  1867.        Shell to DOS or with the Macro Processor.
  1868.  
  1869.        CO-PIF.DVP can be changed with the CP (Change Program) command on
  1870.        the Open Window menu.  You may also want to change the directory
  1871.        information or other parameters.
  1872.  
  1873.        Here are some tips on using {COMMO} with DESQview:
  1874.  
  1875.           If you switch to another task, do not attempt to access any files
  1876.           which may be in use in the {COMMO} window.  Examples are the
  1877.           Capture File, the Screen Image File and files that may be
  1878.           currently involved in a file transfer (upload or download).  The
  1879.           result may be a loss of part or all of the data in the file. 
  1880.           This is a general DESQview no-no.  You may freely access these
  1881.           files in the Shell to DOS or Macro Processor features of {COMMO}
  1882.           (within the same window).
  1883.  
  1884.           If the window is too small, {COMMO} will not be able to load the
  1885.           Online Help file.  To use Online Help you will need a window with
  1886.           about 64k of memory available AFTER loading {COMMO}.  Since the
  1887.           Online Help file is loaded only when requested, you needn't be
  1888.           concerned if you don't intend to use it.
  1889.  
  1890.           The video display may seem less smooth in DESQview.  This is a
  1891.           result of {COMMO} using the fastest possible display method, and
  1892.           is quite normal.
  1893.  
  1894.           The Snow Checking toggle should not be used when {COMMO} is run
  1895.           under DESQview.  If you see "snow" type interference in your CGA
  1896.           display, use DESQview's own snow checking (request "synchronized
  1897.           access" in the Setup program).
  1898.  
  1899.  
  1900.  
  1901.                           Welcome to {COMMO} (tm)                   page 33
  1902.  
  1903.  
  1904.  
  1905.        OmniView
  1906.        --------
  1907.  
  1908.        Display bleed-through may be avoided by telling OmniView that
  1909.        {COMMO} "Supports TopView Functions" or by using the "/T" switch on
  1910.        the OmniView command line.
  1911.  
  1912.        See the tips on using {COMMO} with DESQview in the previous section,
  1913.        which apply to OmniView as well.
  1914.  
  1915.  
  1916.  
  1917.                           Welcome to {COMMO} (tm)                   page 34
  1918.  
  1919.  
  1920.        ----------   -----------------
  1921.        Appendix C   XON/XOFF Protocol
  1922.        ----------   -----------------
  1923.  
  1924.        The XON/XOFF protocol is in effect at all times.  XON/XOFF is
  1925.        especially important when the Print Log is on, since the printer is
  1926.        a slow device relative to the transmission rate of data.
  1927.  
  1928.        {COMMO} will send an XOFF (^S) to pause the remote when data is
  1929.        coming in too fast, and then send an XON (^Q) when it has caught up. 
  1930.        If you attempt to type a character to the remote during a pause a
  1931.        beep will sound (the character will be ignored).  Try typing the
  1932.        character again; if that fails turn off the Print Log.  
  1933.  
  1934.        This situation may arise, for example, if you want to type a ^K to
  1935.        stop the output of the BBS (you probably want to stop the Print Log
  1936.        at this point anyway).
  1937.  
  1938.  
  1939.  
  1940.                           Welcome to {COMMO} (tm)                   page 35
  1941.  
  1942.  
  1943.        ----------   ------------------------------
  1944.        Appendix D   ASCII Character Representation
  1945.        ----------   ------------------------------
  1946.  
  1947.        Sometimes it is necessary to enter special characters in the {COMMO}
  1948.        support files (Configuration File, Dialing Directory and Macro File)
  1949.        or as input to {COMMO} key commands.
  1950.  
  1951.        As an example, suppose you wanted to put a carriage return into a
  1952.        SEND macro function.  If you pressed the Enter key while typing into
  1953.        the Macro File, {COMMO} would think you simply wanted the cursor to
  1954.        go to the beginning of the next line.
  1955.  
  1956.        In other words, certain control characters are used in the operation
  1957.        of {COMMO} and need to be entered in a special way if they are to be
  1958.        used as data.  This section defines how to represent these
  1959.        characters as data.
  1960.  
  1961.  
  1962.        In general, Curly braces { } may ONLY appear as shown in the
  1963.        descriptions and examples for each of the support files.
  1964.  
  1965.  
  1966.        ASCII Data Strings
  1967.        __________________
  1968.  
  1969.        Strings of ASCII characters appear in many places in the {COMMO}
  1970.        support files, including:
  1971.  
  1972.           Modem initialization string        (Config. File)
  1973.           Dial prefixes                      (Config. File)
  1974.           Dial suffix                        (Config. File)
  1975.           Telephone number                   (Dialing Directory)
  1976.           Password string                    (Dialing Directory)
  1977.           Strings in macro functions such as
  1978.                SEND, SETLook and LOOKfor     (Macro File)
  1979.  
  1980.        Note that most of these are sent to the modem.
  1981.  
  1982.  
  1983.        The following characters have special significance in ASCII Data
  1984.        strings:
  1985.  
  1986.           The vertical bar (|) represents a carriage return.
  1987.  
  1988.           The tilde (~) forces a one-half second delay (modem output only).
  1989.  
  1990.           The pound sign (#) will cause the current Password String to
  1991.           be sent in its place (in the SEND function only).
  1992.  
  1993.  
  1994.  
  1995.                           Welcome to {COMMO} (tm)                   page 36
  1996.  
  1997.  
  1998.        Every character in the extended ASCII chart may be represented:
  1999.  
  2000.           The caret (^) is used to represent ASCII values which may not be 
  2001.           entered from the keyboard:
  2002.  
  2003.             0  ... ^@      7  ... ^G      14 ... ^N      21 ... ^U
  2004.             1  ... ^A      8  ... ^H      15 ... ^O      22 ... ^V
  2005.             2  ... ^B      9  ... ^I      16 ... ^P      23 ... ^W
  2006.             3  ... ^C      10 ... ^J      17 ... ^Q      24 ... ^X
  2007.             4  ... ^D      11 ... ^K      18 ... ^R      25 ... ^Y
  2008.             5  ... ^E      12 ... ^L      19 ... ^S      26 ... ^Z
  2009.             6  ... ^F      13 ... ^M      20 ... ^T      27 ... ^[
  2010.  
  2011.           The caret (^) is also used to represent the following:
  2012.  
  2013.             {  ... ^(      the left curly brace
  2014.             }  ... ^)      the right curly brace
  2015.             |  ... ^|      the vertical bar
  2016.             ~  ... ^~      the tilde
  2017.             #  ... ^#      the pound sign
  2018.             ^  ... ^^      the caret
  2019.  
  2020.        These particular characters should only appear in this form, while
  2021.        others such as ASCII 28 through 31 and those in the upper 128
  2022.        extended character set may be typed using the Alt-numeric-keypad
  2023.        method as follows:
  2024.  
  2025.           1. Hold down the Alt key (and keep it down).
  2026.  
  2027.           2. Enter the ASCII code in decimal using the numeric keypad keys
  2028.              (1, 2 or 3 digits are ok).
  2029.  
  2030.           3. Release the Alt key.
  2031.  
  2032.        ASCII 28 through 31 may also be typed using the Ctrl key on your
  2033.        keyboard:
  2034.  
  2035.             28 ... Ctrl \
  2036.             29 ... Ctrl ]
  2037.             30 ... Ctrl 6
  2038.             31 ... Ctrl -
  2039.  
  2040.        All other characters are entered in the usual manner.
  2041.  
  2042.  
  2043.  
  2044.                           Welcome to {COMMO} (tm)                   page 37
  2045.  
  2046.  
  2047.        ----------   ------------------
  2048.        Appendix E   Terminal Emulation
  2049.        ----------   ------------------
  2050.  
  2051.        Terminal Emulation Type is indicated on the status line (to the
  2052.        right of the Line Parameters).  Available types are:
  2053.  
  2054.                A   ANSI-BBS   Used on bulletin boards and other systems
  2055.                V   VT102      Used on minicomputers and mainframes
  2056.                T   TTY        Supports only the basic control characters
  2057.  
  2058.        Initial Terminal Emulation Type is set in the Configuration File. 
  2059.        Terminal Type may be changed at any time using the Alt-L key
  2060.        command.  When a change is made, a reset of mode parameters will be
  2061.        performed.  It is therefore important that the change be made BEFORE
  2062.        connecting with a host (modes are controlled by the host).
  2063.  
  2064.  
  2065.        Printer Support
  2066.        ---------------
  2067.  
  2068.        {COMMO} supports the ANSI/VT102 printer functions, controlled by the
  2069.        remote system.  The "Printer ON/OFF" function will turn {COMMO}'s
  2070.        Print Log ON/OFF.  The "Dedicated Printing" function will send all
  2071.        input from the serial port directly to the printer.  This allows for
  2072.        "transparent" transmission of printer data, including control codes.
  2073.  
  2074.        The printer should be on and ready to print when either mode is
  2075.        used.  When "Dedicated Printing" is active no characters will be
  2076.        displayed on the screen.
  2077.  
  2078.  
  2079.        ANSI Keyboard Support
  2080.        ---------------------
  2081.  
  2082.        The sample Macro File has support for the following special keys
  2083.        that are used with some BBS full-screen editors and in conjunction
  2084.        with VT102 keyboard simulation (^ indicates the Ctrl key):
  2085.  
  2086.                Four cursor (arrow) keys
  2087.                Home   - Home cursor
  2088.                ^Home  - Insert line
  2089.                PgUp   - Page up
  2090.                ^PgUp  - Delete line
  2091.                PgDn   - Page down
  2092.                ^PgDn  - Clear screen
  2093.                End    - End of line
  2094.                Ins    - Insert mode
  2095.                Del    - Delete
  2096.                ^bs   -  Ctrl backspace (delete)
  2097.  
  2098.        The four cursor keys are auto-switched by the host system between
  2099.        cursor mode and application mode.
  2100.  
  2101.  
  2102.  
  2103.                           Welcome to {COMMO} (tm)                   page 38
  2104.  
  2105.  
  2106.        VT102 Keyboard Simulation
  2107.        -------------------------
  2108.  
  2109.        Two keyboard files provide additional support to simulate the VT102
  2110.        keyboard.  One of these should be merged into your Macro File if you
  2111.        intend to use VT102 Emulation.  Be sure that you have no conflicting
  2112.        key-id's in your Macro File (remember that {COMMO} will use the
  2113.        first occurrence of a key-id).
  2114.  
  2115.        These files may be modified to create any keyboard support you
  2116.        desire (see description of VTCUr and VTPAd functions in the section
  2117.        "{COMMO} Macro Functions."
  2118.  
  2119.        VT102 keypad keys are auto-switched by the host system between
  2120.        numeric mode and application mode.
  2121.  
  2122.        VT102-1.MAC
  2123.        ___________
  2124.  
  2125.        This file contains keyboard assignments that work best with the
  2126.        enhanced keyboard (because of the separate cursor keys, etc.).
  2127.  
  2128.        With Numlock ON the ten digits and period will simulate their
  2129.        equivalent VT102 functions.  In addition:
  2130.  
  2131.                F1 to F4 simulate PF1 to PF4
  2132.                Grey * is used for comma
  2133.                Grey - is used for dash
  2134.                Grey + is used for Enter
  2135.  
  2136.        VT102-2.MAC
  2137.        ___________
  2138.  
  2139.        This file contains keyboard assignments that work best with the 83-
  2140.        key keyboard (because of the location of the function keys on the
  2141.        left side).
  2142.  
  2143.        The following diagram shows how the ten function keys (Fn) and ten
  2144.        shifted function keys (SFn) relate to the VT102 keypad keys:
  2145.  
  2146.  
  2147.                F1=  PF1    F2=  PF2    SF1=  PF3    SF2=  PF4
  2148.  
  2149.                F3=   7     F4=   8     SF3=   9     SF4=   -
  2150.  
  2151.                F5=   4     F6=   5     SF5=   6     SF6=   ,
  2152.         
  2153.                F7=   1     F8=   2     SF7=   3     SF8=   Enter
  2154.  
  2155.                F9=   0     F10=  0     SF9=   .     SF10=  Enter
  2156.  
  2157.  
  2158.  
  2159.  
  2160.                                    - end -
  2161.  
  2162.